Guía de Uso: Script de Auditoría SEO Inicial para Agencias
Creado por Gema Calderón Sayoux (gemacalderonsayoux.com)
¡Gracias por descargar esta herramienta! Este script de Python ha sido diseñado para que, como agencia, puedas generar informes de auditoría SEO de la página de inicio de forma rápida, profesional y personalizada con tu propia marca y propuestas de solución.
Sigue estos pasos para ponerlo en marcha en menos de 5 minutos.
1. Requisitos Previos (Lo que necesitas tener)
Antes de empezar, asegúrate de cumplir con dos requisitos básicos:
Python instalado: La mayoría de los ordenadores con macOS y Linux lo tienen. En Windows, puede que necesites instalarlo desde python.org.
Instalar las librerías necesarias: Este script depende de varios componentes externos. Abre una terminal o consola de comandos (CMD o PowerShell en Windows) y ejecuta el siguiente comando. Esto descargará e instalará todo lo necesario:
Generated bash
pip install requests beautifulsoup4 fpdf2 validators python-whois
Use code with caution.
Bash
2. Configuración del Script (¡El paso más importante!)
A diferencia de otros scripts, no necesitas modificar el código principal. Toda la personalización se hace en una sección de configuración al principio del archivo.
Abre el archivo .py con cualquier editor de texto (como Visual Studio Code, Sublime Text o incluso el Bloc de notas) y rellena los siguientes apartados:
CONFIGURACION_AGENCIA: Aquí pones tus datos.
NOMBRE_AGENCIA: El nombre de tu agencia. Aparecerá en el título del PDF.
TITULO_INFORME: El título que quieres para el reporte. ¡Sé creativo!
URL_A_AUDITAR: La página web completa (con https://) del cliente que vas a analizar.
API_KEY_PAGESPEED: Tu clave personal de Google para medir la velocidad web. Es muy recomendable que la incluyas.
SOLUCIONES_PROPUESTAS: ¡Esta es tu oportunidad de vender! Para cada punto de la auditoría (título, H1, velocidad, etc.), escribe tu propia propuesta de solución. Este texto aparecerá en el informe, mostrando al cliente cómo tu agencia resolverá sus problemas.
TEXTO_PROPUESTA_FINAL: Personaliza el mensaje de cierre del informe. Es el lugar perfecto para explicar tus siguientes pasos, invitar a una reunión y dejar una llamada a la acción clara.
3. Cómo Obtener tu API Key de Google PageSpeed (Paso a Paso)
Medir la velocidad web es crucial. Seguir estos pasos te dará una clave API gratuita para que el script pueda hacerlo automáticamente.
Ve a la Consola de Google Cloud: Abre tu navegador y ve a https://console.cloud.google.com/. Inicia sesión con tu cuenta de Google.
Crea un Nuevo Proyecto:
En la parte superior, haz clic en el selector de proyectos (al lado del logo de Google Cloud).
Haz clic en "PROYECTO NUEVO".
Dale un nombre fácil de recordar, como API PageSpeed Agencia, y haz clic en "CREAR".
Habilita la API:
Asegúrate de que tu nuevo proyecto esté seleccionado.
En el menú de navegación de la izquierda (≡), ve a "APIs y servicios" > "Biblioteca".
En la barra de búsqueda, escribe PageSpeed Insights API y presiona Enter.
Haz clic en el resultado y luego en el botón azul "HABILITAR".
Crea tu Clave API:
Una vez habilitada, ve a la sección "Credenciales" en el menú de la izquierda.
Haz clic en "+ CREAR CREDENCIALES" en la parte superior y selecciona "Clave de API".
¡Listo! Se generará una clave. Haz clic en el icono de copiar para guardarla.
Pégala en el Script: Vuelve a tu archivo .py y pega esta clave en el campo API_KEY_PAGESPEED.
(Opcional: puedes crear una imagen como esta para tu web)
4. Ejecutar el Script y Generar el Informe
Una vez que has guardado tus cambios en el archivo .py:
Abre una terminal o consola de comandos.
Navega hasta la carpeta donde guardaste el script. Por ejemplo:
Generated bash
cd Documentos/AuditoriasSEO
Use code with caution.
Bash
Ejecuta el script con Python:
Generated bash
python nombre_del_script.py
Use code with caution.
Bash
(Reemplaza nombre_del_script.py por el nombre real del archivo).
El script comenzará a trabajar, mostrando el progreso en la consola. Cuando termine, aparecerá un mensaje de ¡ÉXITO! y encontrarás un archivo PDF en la misma carpeta, listo para enviar a tu cliente.
5. Solución de Problemas Comunes (FAQ)
Error ModuleNotFoundError: Significa que te falta instalar alguna librería. Vuelve al paso 1 y asegúrate de ejecutar el comando pip install correctamente.
El script dice "URL no válida": Verifica que la URL en URL_A_AUDITAR sea correcta y completa (debe empezar con http:// o https://).
El informe PDF tiene caracteres extraños (ej. ?): El script está preparado para el español, pero si una web usa caracteres muy específicos, pueden no renderizarse bien. El PDF se generará igualmente con el resto de la información.
No se obtienen los datos de Core Web Vitals: Asegúrate de que has pegado bien tu API Key de Google y que has habilitado la API de PageSpeed Insights en la consola de Google Cloud (Paso 3).